home *** CD-ROM | disk | FTP | other *** search
/ MacWorld 1999 March - Disc 1 / Macworld (1999-03) (Disk 1).dmg / Shareware World / Utilities / Text Processing / Alpha / Help / Readme < prev    next >
Encoding:
Text File  |  1998-12-16  |  9.2 KB  |  178 lines  |  [TEXT/ALFA]
  1. Alpha version 7.1
  2.  
  3. International users: select your keyboard in the international preferences 
  4. dialog (Config->Preferences->International), and activate the 
  5. 'International Menus' package (Preferences->Menus and Features...)  to 
  6. ensure the menus contain key-bindings suitable for your keyboard.
  7.  
  8. Remember, Alpha has a Home Page, from which you can check for new 
  9. versions of Alpha, as well as the many modes and packages which have 
  10. been written.  If you wish to download those things directly you can 
  11. get them from <ftp://alpha.olm.net/pub/packages/>, but Alpha contains 
  12. menu items to allow you to check for and/or download and install 
  13. updated items automatically.  Many packages are also available from: 
  14. <ftp://ftp.ucsd.edu/alpha/>.  If you check both locations, Alpha will 
  15. keep track of which contains the most recent one for you.
  16.  
  17. Alpha's documentation is currently a little out-of-date.  It is 
  18. undergoing a complete overhaul.  To check on the status of that 
  19. overhaul, go to <http://www.theophys.kth.se/~jl/Alpha/newdocs.html>.  
  20. In the mean-time, you may look at the current Manual, a shorter 
  21. Quick Start (<-- click on it!)  document, and many other help files.  
  22. You can access the help files under the system help menu.  If you have 
  23. recently updated Alpha you may wish to read the 'Changes' file.  If 
  24. you previously used Alpha, you may find some of its functionality 
  25. missing: that's becuase it has been placed in a separate package.  
  26. Read and download from the list of packages below (or look in the 
  27. packages menu to see if it was pre-installed).
  28.  
  29. PLEASE use the Alpha-D mailing list to discuss problems, suggestions 
  30. etc with this release.  To subscribe, email <LISTSERV@LISTSERV.SYR.EDU> 
  31. and, in the text of your message (not the subject line), write: 
  32. 'SUBSCRIBE ALPHA-D'.  There are a number of known bugs which will hopefully
  33. be corrected in a future release.  PLEASE read the 'Bug Reports and Debugging' 
  34. file for a list of known bugs, and for how to give an informative bug 
  35. report, without which it is unlikely any bug you found can be fixed.
  36.  
  37. Starting with version 7.0, Alpha can use 'packages' or 'extensions' --- 
  38. these provide enhancements to Alpha's menus or other editing abilities.  
  39. Some such packages come pre-installed with Alpha; you may download any of a 
  40. large number of others from one of Alpha's internet sites (there are now 
  41. more than thirty such packages available).  The 'Config->Preferences->Menus 
  42. And Features' and 'Config->Mode Prefs->Menus and Features' menu items let 
  43. you turn extensions on and off.  The 'Config->Package Prefs' menu allows 
  44. you to update modes, menus, and extensions quickly and easily by 
  45. downloading small update files from the internet.  For those used to Emacs, 
  46. a 'mode' in Alpha is like a 'major mode' in Emacs, an 'extension' or 
  47. 'feature' in Alpha is like a 'minor mode' in Emacs.
  48.  
  49. Alpha stores its preferences in a folder called 'Alpha-v7' in your 
  50. preferences folder.  Do not just copy over your old preferences (if you 
  51. used Alpha before the 7.0 release).  Alpha has undergone sufficient changes 
  52. that it will probably be incompatible with many existing preferences files.  
  53. See the end of this document for instructions on copying over your 
  54. preferences.
  55.  
  56. Scroll down to read a brief description of some of the current packages, 
  57. and click on the hyper-links to retrieve them from one of Alpha's package 
  58. archive sites.  You may also use the 'Config' menu, (select 'Package 
  59. Prefs->Internet Updates') to download and install them.  Since most web 
  60. browsers take so long to startup, it may be better to start them up before 
  61. clicking on any link below (prevents time-out problems).
  62.  
  63. Click here to update Alpha's list of remote packages via the internet.
  64. (you may need to do that so Alpha knows about the following packages)
  65.  
  66. ===============================================================================
  67. Current extension packages for Alpha include:
  68.  
  69. Smart Paste --- when cutting and pasting code-segments, 'paste' will
  70.     automatically indent the code it pastes to match the surrounding code.
  71.     <get smartPaste.tcl>
  72. TeX mode --- powerful editing features for single or multi-part LaTeX 
  73.     documents.  Integrates well with all current TeX implementations.
  74.     <get TeXmode>
  75. HTML mode --- for editing and manipulating suites of Web pages, allowing
  76.     entire site maintenance from within Alpha.
  77.     <get HTMLmode>
  78. Perl mode --- for editing Perl documents
  79.     <get Perlmode>
  80. BibToHtml --- conversion scripts for bibtex files.
  81.     <get BibToHtml.tcl>
  82. LaTeX Accents --- conversion from LaTeX control sequences to real
  83.     accented characters and vice versa.
  84.     <get latexAccents.tcl>
  85. LaTeX MathBB --- quicker typing of blackboard-bold symbols.
  86.     <get latexMathbb.tcl>
  87. Emacs --- makes many of Alpha's key sequences mimic those of the popular
  88.     Unix editor 'Emacs'
  89.     <get Emacs>                     
  90. Macros --- allows you to record, save and replay keyboard macros.
  91.     <get macros.tcl>                    
  92. Diff mode --- powerful side-by-side comparison and patching between files or
  93.     directories.
  94.     <get DiffMode>
  95. Programmer's Menus --- menus for interacting with Symantec, Metrowerks and 
  96.     other common programming environments (primarily C, C++)
  97.     <get programmersMenus>
  98. Printer choices --- creates a printer sub-menu, allowing you to print using
  99.     Enscriptor, Kodex, Drop•ps or PrettyC as well as directly from Alpha.
  100.     <get printerChoicesMenu>        
  101. Ftp menu --- interaction with any of the popular Ftp clients.
  102.     <get ftpMenu.tcl>                   
  103. Vince's Additions --- a large suite of packages, used by many
  104.     Electric completions --- speeds up editing of C++, TeX, Java, Tcl 
  105.         documents with template insertions and sophisticated 'complete-
  106.         what-I-just-typed' features.
  107.     Electric menu --- to give menu access to some of the electric features.
  108.     Bib engine --- sophisticated interaction with Vince's port of BibTeX.
  109.     Bib convert --- conversion of Inspec and Hollis records to .bib format.
  110.     Mode search paths --- declare where you keep files/headers for different
  111.         modes so Alpha can find your files more easily.  Especially useful
  112.         for C++ programmers (finds those header files).
  113.     Document projects --- declare the projects your are working on, the
  114.         default document structures you use, and Alpha handles the rest.
  115.     File utils --- adds a few simple file utilities to Alpha's menus
  116.     <get VinceAdditions>           
  117. Voodoo menu --- interaction with the version control software 'Voodoo'
  118.     <get voodooMenu>                
  119. Copy ring --- maintain more than one piece of copied text for pasting.
  120.     <get copyRing.tcl>
  121. Compare windows --- find the next difference between two windows, very quickly,
  122.     and unobtrusively.
  123.     <get compareWindows.tcl> 
  124. Developer utilities --- to help you write new packages for Alpha.
  125.     <get developerUtilities.tcl>        
  126. Frontier menu --- interaction with Frontier.
  127.     <get frontierMenu>              
  128. Eudora menu --- interaction with Eudora; you can write your email in Alpha.
  129.     <get eudoraMenu>                
  130. Internet config menu --- interaction with Internet Config, and hence all of
  131.     your internet applications.
  132.     <get internetConfigMenu>        
  133. Recent Files --- maintains a menu of recently used files, for quick access.
  134.     <get recentFilesMenu.tcl>           
  135. Switch To --- keeps a menu of commonly used applications, for quick 
  136.     switching.
  137.     <get switchToMenu.tcl>              
  138. New Document --- instead of opening blank 'untitled' documents with cmd-N,
  139.     this package allow you to select a document type or template (if used
  140.     with the Document Projects package).  You can directly start an email
  141.     message, browse an ftp site, or create a new C++ class template.
  142.     <get newDocument.tcl>               
  143. Smarter Source --- allows you selectively to over-ride parts of Alpha's
  144.     core Tcl code without making changes to the core files (easier for you
  145.     to upgrade Alpha, keeping your changes intact).
  146.     <get smarterSource.tcl>             
  147.  
  148.  
  149.                      
  150. ===============================================================================
  151. Copying over old preferences:
  152.  
  153. Alpha stores most preferences in the 'defs.tcl' and 'arrdefs.tcl' files in 
  154. your preferences folder.  The preferences folder is in the standard system 
  155. preferences folder, and is named 'Alpha' (for versions < 7.0) or Alpha-v7
  156. for version 7 (and will be called Alpha-v8 when version 8.0 is released at 
  157. some point in the future...)
  158.  
  159. Some of your old preferences will be incompatible/irrelevant to the new 
  160. Alpha version when you upgrade from 6.x to 7.x therefore you shouldn't just 
  161. copy the two prefs files from one folder to the other.
  162.  
  163. Here's how to copy over just a few preferences: open the old 'defs.tcl' or 
  164. 'arrdefs.tcl' and examine them for lines you wish to copy.  Open the new 
  165. 'defs.tcl' and 'arrdefs.tcl'.  Alpha opens them in read-only mode, but you 
  166. can command-click on the 'lock' icon in the window to make the windows 
  167. modifiable.  Now copy and paste as you desire.  Finally save the windows and 
  168. quit and restart Alpha.  If you get an error on startup, you probably copied 
  169. over incompatible preferences and you'll have to delete the files and start 
  170. over (hence it may be a good idea to make a backup copy of the originals 
  171. before you start).
  172.  
  173. Note: if you don't wish to use a System-Folder prefs folder, create a folder
  174. called 'AlphaPrefs' next to the Alpha application.  Alpha will use that
  175. folder preferentially if it exists.
  176.  
  177.  
  178.